home *** CD-ROM | disk | FTP | other *** search
/ Dr. Windows 3 / dr win3.zip / dr win3 / MISCELLA / SUNPO131.ZIP / SUNPO131.DOC < prev    next >
Text File  |  1993-09-15  |  34KB  |  692 lines
  1.  
  2.  
  3.  
  4.         ******* WARNING ***** WARNING ***** WARNING ***** WARNING *********
  5.         *                                                                 *
  6.         * THE AUTHOR OF THIS SOFTWARE DOES NOT PROVIDE ANY WARRANTY WHAT- *
  7.         * SOEVER! YOU USE IT OR TRY IT ENTIRELY AND STRICTLY AT YOUR OWN  *
  8.         * RISK. THE AUTHOR EXPRESSLY DISCLAIMS ANY LIABILITY FOR DAMAGE   *
  9.         * TO YOUR COMPUTER, FILES OR ASSOCIATED ELECTRO-MECHANICAL        *
  10.         * DEVICES. NOR IS THERE ANY GUARANTEE AS TO THE ACCURACY OF THE   *
  11.         * RESULTS OR AS TO THE FITNESS OF THE SUNPO PROGRAMS FOR ANY PAR- *
  12.         * TICULAR PURPOSE.                                                *
  13.         *                                                                 *
  14.         *    REMEMBER, YOU USE IT OR TRY IT SOLELY AT YOUR OWN RISK!      *
  15.         *                                                                 *
  16.         ******* WARNING ***** WARNING ***** WARNING ***** WARNING *********
  17.  
  18.         1.0 GENERAL INFORMATION
  19.         
  20.         SUNPO will calculate the azimuth and elevation of the sun as a
  21.         function of the date and time of day at any place on the earth
  22.         (with the possible exception of the poles and precisely where the
  23.         0 or 180 degree meridians cross the equator). It will also compute
  24.         the approximate times of sunrise and sunset and the azimuth of the
  25.         sun at those times. In addition, SUNPO provides estimates of the
  26.         sea level solar intensities at visible, uv-a and uv-b wavelengths.
  27.         SUNPO does not take careful account of the fact that a year isn't
  28.         composed of exactly 365 twentyfour hour days, so you may expect
  29.         errors of a few degrees over a leap year cycle.
  30.  
  31.         Why would you want to know such things? Use your imagination!
  32.         Maybe you would like to know where the sun sets on June 21 (the
  33.         approximate date of the summer solstice in the northern hemi-
  34.         sphere) so that you can figure out where to plant a tree to put
  35.         the shade just where you want it on the longest day of the year.
  36.         Maybe you want to decide how big to make some awnings so that they
  37.         will block the sun's direct rays (or pass them) in some particular
  38.         season. SUNPO's ultraviolet intensity values can help you choose the
  39.         times of day for minimizing your exposure to damaging radiation.
  40.         SUNPO will tell you what you need to know about the sun's position
  41.         and approximate sea level intensity values if you can figure out
  42.         reasons to know them!
  43.  
  44.         SUNPO's results are displayed as a table showing the local and GMT
  45.         time in a 24 hour "military" format (for example, 6:34 PM would
  46.         appear as 1834). Azimuth angles are measured clockwise from north
  47.         (so, due south corresponds to an azimuth angle of 180 degrees).
  48.         Elevations are measured from a level horizon (straight up is a 90
  49.         degree elevation angle). Results may be saved in an ascii formatted
  50.         file for later printing if desired. There is also an internal print
  51.         command but it funtions properly IF and ONLY IF your default Windows
  52.         printer has graphics capabilities.
  53.  
  54.         In order to actually run SUNPO you need to know your geographical
  55.         longitude and latitude in at least degrees and minutes. You also
  56.         need to know or figure out a "time zone" value for your location.
  57.         Data for a few cities may be found below.
  58.  
  59.         Please note: The graphing portion of SUNPO version 1.31 requires that
  60.         the computer be equipped with at least an 80286 cpu and an 80x87 math
  61.         coprocessor or equivalent.
  62.  
  63.  
  64.  
  65.  
  66.         SUNPO is distributed as Shareware. That means you may try it for a
  67.         reasonable period (say three weeks) at no cost, but that you should
  68.         register it and pay the registration fee if you use it after the
  69.         trial period. SUNPO is available as both a Windows (3.0) appli-
  70.         cation and as a DOS executable program (without intensity values).
  71.  
  72.         The Windows version was written using Borland International's
  73.         Turbo Pascal for Windows, and uses the Graphics Server software
  74.         marketed by Pinnacle Publishing, Inc. The DOS version was compiled
  75.         using Borland's Turbo Pascal version 4.0.
  76.         
  77.         Windows and MS-DOS are trademarks of Microsoft Corporation.
  78.         Turbo Pascal is a trademark of Borland International,Inc.
  79.                
  80.         2.0 INSTALLATION INFORMATION
  81.  
  82.         2.1 STANDARD FILES
  83.         
  84.         The SUNPO files included in the authorized archive are:
  85.  
  86.              SUNPO131.EXE - Windows 3.x executable application file.
  87.              SUNPO.INI    - Initialization file for SUNPO131.
  88.              SUNPO.DTA    - Radiance data file.
  89.              SUNPO131.DOC - This file
  90.              SUNPOD12.EXE - DOS executable program file.
  91.              SUNPO.BMP    - Logo bitmap file.
  92.              GSW.EXE      - Graphics server executable file.
  93.              GSWDLL.DLL   - Dynamic link library for graphics server.
  94.              CHANGES.TXT  - Brief remarks on changes for this verion.
  95.              READTHIS.NOW - Minimal installation information.
  96.  
  97.         McAffee Associates' Validate 4.0 anti-virus information:
  98.  
  99.  
  100.           File Name:  sunpo131.exe
  101.                Size:  115,968
  102.                Date:  9-15-1993
  103.                File Authentication:
  104.                     Check Method 1 - 02A1
  105.                     Check Method 2 - 0363
  106.  
  107.           File Name:  sunpod12.exe
  108.                Size:  31,088
  109.                Date:  3-16-1993
  110.                File Authentication:
  111.                     Check Method 1 - E2F1
  112.                     Check Method 2 - 1AA6
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.         2.1 INSTALLATION HINTS
  120.         
  121.         SUNPO is so simple that no installation program is provided,
  122.         but some basic instructions follow. (Actually, the developer
  123.         does not know how to write a carefree installation program!)
  124.  
  125.  
  126.         2.1.1 DOS Version
  127.         
  128.         If you want to run from a fixed disc, then copy SUNPOD12.EXE to
  129.         any directory you choose. Start it in the usual fashion for DOS
  130.         programs either from the fixed disc or a diskette. The DOS version
  131.         is interactive and queries you for needed data as it runs. However
  132.         it might be helpful to read some of the comments later in this
  133.         file.
  134.         
  135.         2.1.2 Windows Version
  136.  
  137.         The Windows version may also be run from either a fixed disc drive
  138.         or directly from a diskette that contains all the dearchived files.
  139.         The notes which follow apply to setting up SUNPO on a fixed disc,
  140.         using a DOS Window or perhaps the File Manager.
  141.  
  142.         While assorted components of SUNPO can be placed in any number of
  143.         directories if your PATH statement has the right properties, it is
  144.         recommended that all of the SUNPO files (except SUNPO.INI, see below)
  145.         be placed in a single dir ectory or sub-directory. That simplifies
  146.         both installation and removal. SUNPO.INI MUST be placed in your
  147.         "base" Windows directory if you wish to use it. An installation
  148.         example follows:
  149.  
  150.         This example assumes the following:
  151.  
  152.         A) Your base Windows directory is C:\WINDOWS.
  153.         B) You will place all SUNPO files (EXCEPT SUNPO.INI, which MUST
  154.             be in your base Windows directory) in a NEW directory on fixed
  155.             drive D:
  156.         C) The (de-archived) SUNPO files are on a diskette in diskette
  157.            drive B:, and there are no other files on that diskette.
  158.         D) The installation will be done from DOS or a DOS Window, and that
  159.            your DOS "prompt" appears as C:\>
  160.  
  161.         Note: in the following example the term <CR> means that you press the
  162.               "RETURN" or "ENTER" key.
  163.  
  164.         1) Create the SUNPO directory:
  165.  
  166.            C:\> MKDIR D:\SUNPO <CR>
  167.  
  168.         2) Copy files:
  169.  
  170.            C:\> Copy B:\SUNPO.INI C:\WINDOWS
  171.            C:\> Copy B:\*.* D:\SUNPO
  172.  
  173.  
  174.  
  175.